.. highlightlang:: us

.. index:: @f{xyzstatvalue}

.. _@f{xyzstatvalue}:

@f{xyzstatvalue}
================

.. us.tag  @f{xyZstatvalue} GERMAN fieldfunction New5506

Schreibt eine statistische Kennzahl für den angegebenen 3D-Datensatz in ein 
Textobjekt oder eine Tabellenzelle.

.. function::  @f{xyzstatvalue(DatasetName, Type)}
               @f{xyzstatvalue(DatasetName, Type, Format)}

.. us.params

**Parameter**

.. uparam:: DatasetName

   Ist der Name eines 3D-Datensatzes.

.. uparam:: Type

   Ist der Name der statistischen Kennzahl:

   .. list-table::
      :header-rows: 1

      * - Wert
        - Bedeutung
      * - xmin
        - Wert der kleinsten x-Koordinate
      * - xmax
        - Wert der größten x-Koordinate
      * - ymin
        - Wert der kleinsten y-Koordinate
      * - ymax
        - Wert der größten y-Koordinate
      * - zmin
        - Wert der kleinsten z-Koordinate
      * - zmax
        - Wert der größten z-Koordinate
      * - xmean
        - arithmetischer Mittelwert der x-Koordinate
      * - ymean
        - arithmetischer Mittelwert der y-Koordinate
      * - zmean
        - arithmetischer Mittelwert der z-Koordinate
      * - zminposx
        - x-Position der kleinsten z-Koordinate
      * - zminposy
        - y-Position der kleinsten z-Koordinate
      * - zmaxposx
        - x-Position der größten z-Koordinate
      * - zmaxposy
        - y-Position der größten z-Koordinate
      * - meandeviation
        - Berechnet die mittlere Abweichung.
      * - variance
        - Berechnet die Kovarianz.
      * - standarddeviation
        - Berechnet die Standardabweichung, normiert auf n-1
      * - standarddeviation2
        - Berechnet die Standardabweichung 2 sigma, normiert auf n-1
      * - median
        - Berechnet das 0.5 Quantil.
      * - quantile
        - Berechent ein beliebiges Quantil. Beispielsweise ist das 25%-Quantil
          der Wert, für den gilt, dass 25% aller Werte kleiner sind als dieser
          Wert. Der Prozentwert wird getrennt durch einen Doppelpunkt angehängt. 
          Beispiel: @f{xystatvalue(Data1, quantile:0.1)}
          0.1 für 10 %. Der Wert muss zwischen 0 und 1 liegen.
      * - npoints
        - Gibt die Anzahl der Datenpunkte aus.

.. uparam:: Format

   Legt das Zahlenformat fest. Defaultformat ist ``%g``. Um z. B. drei
   Nachkommastellen auszugeben, können für den Format-Parameter ``%.3lf``
   angegeben werden. Weitere Informationen über den Format-String finden Sie
   unter :ref:`printf`. Innerhalb des Formatstrings darf bei Feldfunktionen kein
   Komma verwendet werden.

.. us.comment

**Kommentar**

Um den Namen eines Datensatzes herauszufinden, klicken Sie den Datensatz mit der
Maus an. Der Name wird dann in der Statuszeile angezeigt, z. B. ``Data3``.
Die Feldfunktion können Sie in ein Textobjekt oder in eine Zelle eines 
Tabellenobjekts einfügen

.. us.example

**Beispiel**

**Example**

.. highlight:: none

::

   z = @f{xyzstatvalue(Data10, zmin)} g/kWh
   x = @f{xyzstatvalue(Data10, zminposx)} 1/min
   y = @f{xyzstatvalue(Data10, zminposy)} Nm

**Output**:

::

   z = 216 g/kWh
   x = 2432 1/min
   y = 138 Nm

.. highlight:: us

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2013.6
     - Neu.

.. seealso::
   :ref:`uberblick-feldfunktionen`,
   :ref:`bearbeitenfelder-aktualisieren`,
   :ref:`diagrammfeldfunktion-einfugen`,
   :ref:`dateialias-tabelle-bearbeiten`

:sub:`id-1879323`